home *** CD-ROM | disk | FTP | other *** search
/ EuroCD 3 / EuroCD 3.iso / Programming / vbcc / machines / amigappc / doc / extralib.doc < prev    next >
Encoding:
Text File  |  1998-06-24  |  2.6 KB  |  77 lines
  1.  
  2. INTRODUCTION
  3.  
  4.     libextra.a is a link library for vbcc which contains certain often
  5.     used functions that are not standard ANSI-functions. It may e.g.
  6.     be helpful in porting programs.
  7.  
  8.  
  9. LEGAL
  10.  
  11.     The functions in libextra.a are written by Kasper B. Graversen and
  12.     Volker Barthelmann.
  13.     libextra.a is public domain.
  14.  
  15.  
  16. USAGE
  17.  
  18.     To link with libextra.a (or the small data version libextras.a) you
  19.     can either use vconfig (add 'extra' or 'extras' in the lib link
  20.     menu) or specify '-lextra' or '-lextras' to vc.
  21.     There is also a header file <extra.h>.
  22.  
  23.  
  24. FUNCTIONS
  25.  
  26.     At the moment extra.lib contains the following functions:
  27.  
  28.     getch()         Similar to getchar() but sets the console to raw mode
  29.                     and does not wait for return.
  30.                     Caution: This will be rather slow on PowerUp!
  31.  
  32.     stricmp()       Case-insensitive variant of strcmp(). Can be inlined
  33.                     by #defining __INLINE_STRICMP when including <extra.h>.
  34.  
  35.     strnicmp()      Case-insensitive variant of strncmp(). Can be inlined
  36.                     by #defining __INLINE_STRNICMP when including <extra.h>.
  37.  
  38.     chdir()         Changes the current directory.
  39.  
  40.     clock()         This is an alternative version of the clock() function
  41.                     in vc.lib. clock() is supposed to return the amount of
  42.                     cpu-time spent by the current program. As this is
  43.                     generally not possible on the Amiga clock() from
  44.                     vc.lib always returns -1.
  45.                     However there seem to be several badly written
  46.                     programs that do not check this. So this version
  47.                     of clock() returns values which are strictly ascending
  48.                     for successive calls to clock() and the difference
  49.                     between them is the time difference between the calls.
  50.                     CAUTION: This will be very slow on PowerUp!
  51.  
  52.     iswhitespace()  Variant of isspace(). Can be inlined by #defining
  53.                     __INLINE_ISWHITESPACE when including <extra.h>.
  54.  
  55.     isseparator()   Tests for ',' or '|'. Can be inlined by #defining
  56.                     __INLINE_ISSEPARATOR when including <extra.h>.
  57.  
  58.  
  59. FUTURE
  60.  
  61.     If you are missing certain functions and would like them to be
  62.     included in extra.lib send a mail to Kasper B. Graversen at
  63.  
  64.         (internet)
  65.         kbg2001@internet.dk
  66.  
  67.         (fidonet)
  68.         2:237/30.7
  69.  
  70.     Please explain the desired functions as detailed as possible (how
  71.     they should work, prototypes, return values in case of errors etc.).
  72.     If possible submit source code for the function.
  73.  
  74.  
  75. Kasper B. Graversen and Volker Barthelmann
  76.  
  77.